IMoniker - Pointer Moniker Implementation

A pointer moniker essentially wraps an interface pointer so that it looks like a moniker and can be passed to those interfaces that require monikers. Binding a pointer moniker is done by calling the pointer s QueryInterface method.

Instances of pointer monikers refuse to be serialized, that is, IPersistStream::Save5_V3OT will return an error. These monikers can, however, be marshaled to a different process in an RPC call; internally, the system marshals and unmarshals the pointer using the standard paradigm for marshaling interface pointers.

When to Use

Pointer monikers are rarely needed. Use pointer monikers only if you need monikers to identify objects that have no persistent representation. Pointer monikers allow such objects to participate in a moniker-binding operation.

Remarks

IMoniker::BindToObject486P_PV

This method queries the wrapped pointer for the requested interface.

IMoniker::BindToStorageCA2I.L

This method queries the wrapped pointer for the requested interface.

IMoniker::Reduce.M4QZ4

This method returns MK_S_REDUCED_TO_SELF and passes back the same moniker.

IMoniker::ComposeWith1M9Y_YZ

If pmkRight is an anti-moniker, the returned moniker is NULL; if pmkRight is a composite whose leftmost component is an anti-moniker, the returned moniker is the composite after the leftmost anti-moniker is removed. If fOnlyIfNotGeneric is FALSE, the returned moniker is a generic composite of the two monikers; otherwise, the method sets *ppmkComposite to NULL and returns MK_E_NEEDGENERIC.

IMoniker::Enum18FKHOZ

This method is not implemented (that is, it returns E_NOTIMPL).

IMoniker::IsEqualJ2_C.R

This method returns S_OK only if both are pointer monikers and the interface pointers that they wrap are identical.

IMoniker::HashF_B.6E

This method calculates a hash value for the moniker.

IMoniker::IsRunning1CR3B7K

This method always returns S_OK, because the object identified by a pointer moniker must always be running.

IMoniker::GetTimeOfLastChange123HWA2

This method is not implemented (that is, it returns E_NOTIMPL).

IMoniker::Inverse4HON_YU

This method returns an anti-moniker (i.e., the results of calling CreateAntiMonikerK5IP0Q).

IMoniker::CommonPrefixWithK6I29R

If the two monikers are equal, this method returns MK_S_US and sets *ppmkPrefix to this moniker. Otherwise, the method returns MK_E_NOPREFIX and sets *ppmkPrefix to NULL.

IMoniker::RelativePathTo8ECMZ1

This method is not implemented (that is, it returns E_NOTIMPL).

IMoniker::GetDisplayName2BE2_IB

This method is not implemented (that is, it returns E_NOTIMPL).

IMoniker::ParseDisplayNameAU2GHS

This method queries the wrapped pointer for the IParseDisplayNameQD_Z28 interface and passes the display name to IParseDisplayName::ParseDisplayNameLEMM77.

IMoniker::IsSystemMonikerXEHS5E

This method returns S_OK and indicates MKSYS_POINTERMONIKER.

See Also